---
title: npm-restart
section: 1
description: Restart a package
github_repo: npm/cli
github_branch: latest
github_path: docs/lib/content/commands/npm-restart.md
redirect_from:
  - /cli-commands/npm-restart
  - /cli-commands/restart
  - /cli-documentation/cli-commands/npm-restart
  - /cli-documentation/cli-commands/restart
  - /cli-documentation/commands/npm-restart
  - /cli-documentation/commands/restart
  - /cli-documentation/npm-restart
  - /cli-documentation/restart
  - /cli-documentation/v11/cli-commands/npm-restart
  - /cli-documentation/v11/cli-commands/restart
  - /cli-documentation/v11/commands/npm-restart
  - /cli-documentation/v11/commands/restart
  - /cli-documentation/v11/npm-restart
  - /cli-documentation/v11/restart
  - /cli/cli-commands/npm-restart
  - /cli/cli-commands/restart
  - /cli/commands/npm-restart
  - /cli/commands/restart
  - /cli/npm-restart
  - /cli/restart
  - /cli/v11/cli-commands/npm-restart
  - /cli/v11/cli-commands/restart
  - /cli/v11/commands/restart
  - /cli/v11/npm-restart
  - /cli/v11/restart
  - /commands/npm-restart
  - /commands/restart
---

### Synopsis

```bash
npm restart [-- <args>]
```

### Description

This restarts a project. It is equivalent to running `npm run restart`.

If the current project has a `"restart"` script specified in `package.json`, then the following scripts will be run:

1. prerestart
2. restart
3. postrestart

If it does _not_ have a `"restart"` script specified, but it does have `stop` and/or `start` scripts, then the following scripts will be run:

1. prerestart
2. prestop
3. stop
4. poststop
5. prestart
6. start
7. poststart
8. postrestart

### Configuration

#### `ignore-scripts`

- Default: false
- Type: Boolean

If true, npm does not run scripts specified in package.json files.

Note that commands explicitly intended to run a particular script, such as `npm start`, `npm stop`, `npm restart`, `npm test`, and `npm run` will still run their intended script if `ignore-scripts` is set, but they will _not_ run any pre- or post-scripts.

#### `script-shell`

- Default: '/bin/sh' on POSIX systems, 'cmd.exe' on Windows
- Type: null or String

The shell to use for scripts run with the `npm exec`, `npm run` and `npm init <package-spec>` commands.

### See Also

- [npm run](/cli/v11/commands/npm-run)
- [npm scripts](/cli/v11/using-npm/scripts)
- [npm test](/cli/v11/commands/npm-test)
- [npm start](/cli/v11/commands/npm-start)
- [npm stop](/cli/v11/commands/npm-stop)
- [npm restart](/cli/v11/commands/npm-restart)
